BBSm CONVENTIONS 



REFERENCE CARD CONVENTIONS 

CAPITAL LETTERS and special characters must be typed 
as shown. 

Words in lower-case describe what to type. 
(Entries in braces are required.} 

[Entries in brackets are optional.] 

Entries in vertical list (i.e. °"j)mean pick one. ■ 

. . . means you may repeat the previous entry. 

COMMAND CONVENTIONS 

Blanks are not allowed. 

Commands other than those in itiate d by the sp ecial keys 

[SEE] B [Tns] IdELI ISTEPl ICANI are 

terminated by a IRETURNI . 
Typing the |CAN| (cancel) key will clear the line currently 

being entered and allow you to start over. 
Some system functions require acknowledgement. Typing 

[y] means yes. Typing \u] or |RETU RN| means no or 

continue 

POWER UP SEQUENCE 

Switch on circuit breaker on back panel of AMDS. 

Turn on disk. 

Insert system diskette into drive 0. 
Initiate desired program 

POWER DOWN SEQUENCE 

Remove diskettes. 
Turn off disk. 

Switch oft circuit breaker on back panel of AMDS. 

FILENAME CONVENTIONS 

[N:][drive-number:J |name j 

N; specifies that the file is to be created. 
If drive-number: is omitted, it defaults to 0. 
name may be up to 10 ASCII characters long. No blanks 
are allowed. 

INITIATING A PROGRAM 
J (system-character} 

There are currently up to 8 Futuredata supplied programs: 



M — Manager 

E — Editor 

A — Assembler 

L — Linker 

D — Debugger 

U — Utility 

B — Basic Interpreter 

C — Basic Compiler 

m COMMAND FILES 



INITIATE COMMAND FILE 
J A I filename} [,parm]. . . 

RETURN TO KEYBOARD INDEFINITELY 
l^promptj A K . . . 

prompt is a string which may be input. The processor 
switches to keyboard until user types A. 

RETURN TO KEYBOARD FOR ONE LINE 
[prompt] A L 

prompt is a string which may be input. The processor 
switches to keyboard until IRETURN] is typed. 

ABORT COMMAND FILE 



SHIFT BREAK 



PARAMETER SUBSTITUTION 
A{n} 

n is a digit from 1 to 9. 

When this sequence occurs in a command file, it causes 
the substitution of the numbered parameter. 



MANAGER 



INITIALIZE DISKETTE 
I [drive-number] 

If drive-number is omitted, it defaults to 1. 



MB MANAGER 



DISPLAY DISKETTE DIRECTORY 

D [drive-number] [p] 

If drive-number is omitted, it defaults to 0. 
If P is appended, the directory will be printed. 

CREATE FILE 

C {filename} [.tracks [.exfension-size]]] 

If .tracks is omitted, it defaults to 1. 
li,extension-slze is omitted, it defaults to 1. 

SCRATCH FILE 
S {filename} 

The manager will request verification. Type Y or N. 
COPY FILE 

M {from-filename} , {lo-filename} 
RENAME FILE 

R {current-filename} , {new-filename} 

EXCHANGE FILENAMES 
E {filename-one} , {filename-two} 

COPY DISKETTE 

X (f rom-drive-number} , {to-drlve-number} [,type] 

type may be one of the following characters: 
A — copy all files 

S — copy only system files (files with Z attribute) 
If ,type is omitted, only non-system files will be copied. 



SPECIFY FILE ATTRIBUTES 
A {filename} [.attribute [attribute]. . .] 
attribute may be one of the following characters: 

S — Source file (text) 

C — Command file (text) 

R — Relocatable object file (binary) 

O — Absolute object file (binary) 

P — Permanent file (non-scratchable) 

W — Write protected tile 

Z — System file 



MANAGER 



DISPLAY DISKETTE DIRECTORY 
D [^drive-number J [^Pj 
If drive-number is omitted, it defaults to 0. 
If P is appended, tlie directory will be printed. 

CREATE FILE 

C (filename} [.tracks [,extension-slze]] 

If , tracks is omitted, it defaults to 1. 

If , extension-size is omitted, it defaults to 1. 

SCRATCH FILE 
S (filename) 

The manager will request verification. Type Y or N. 
COPY FILE 

M (f rom-filename} , (to-fllename} 
RENAME FILE 

R (current-fllenamej , (new-filename) 

EXCHANGE FILENAMES 
E (filename-one) ,(filename-tvKo) 

COPY DISKETTE 

X (f rom-drive-number) , (to-drlve-number) QtypeJ 
type may be one of the following characters; 

A — copy all files 

S — copy only system files (files with Z attribute) 
If ,type is omitted, only non-system files will be copied. 



SPECIFY FILE ATTRIBUTES 
A(filename) [.attribute [attribute]. . .] 
attribute may be one of the following characters: 

S — Source file (text) 

C — Command file (text) 

R — Relocatable object file (binary) 

O — Absolute object file (binary) 

P — Permanent file (non-scratchable) 

W — Write protected file 

z — Svstem file 



Eg3 MANAGER 



EDITOR 



B — Blind file 

FREE UNUSED SPACE IN FILE 
F (filename) 

^sssm EDITOR itfcKa'faa:{ft^»?»igiiBaB 



LOAD EDITOR WORKSPACE 
L [filename] 

If filename is omitted, additional data will be loaded from 
the previously specified filename. 

WRITE EDITOR WORKSPACE 
W [$] [*] [filename] 

If filename is not specified, additional data will be 
appended to the previously specified file. 

If $ is specified, only the top part of the workspace (down 
to but not including the edit line) will be written. 

If * is specified, the written data will not be removed from 
the editor's workspace. 

WRITE THEN LOAD 
N 

Both filenames must have been previously specified. 
END OUTPUT FILE 



ADVANCE EDIT LINE 

s 

AS advances the edit line to the end of the editor 
workspace. 

BACKUP EDIT LINE 

s 

B$ backs up the edit line to the beginning of the editor 
workspace. 



DELETE LINES 
DEL [n] 

If n is not specified, the default is 1 line. 



FIND [and replace] A STRING 
F [^(delim) (siring) (delim) [(rstring) (delim) [a] [v]]J 
delim is a character occuring in neither string nor rstring. 
The command scans for string from the line following the 

current edit line to the end of the workspace. 
If rstring Is specified, the command scans for string from 
the current edit line to the end of the workspace. If string 
is found, it is replaced by rstring. If V is specified, 
verification is requested before replacement. 
If A is specified, the command will repeat until the end of 
workspace is reached. 

GET [and replace] A STRING 
G |^(delim) (string) (delim) [(rstring) (delim) [a] [v]]J 
delim is a character occuring in neither string nor rstring. 
The command scans for string from the line following the 
current edit line to the end of the file. (If the string is not 
found in the editor workspace, the workspace will be 
written and more lines will be read from the file until 
either string is found or the end of the file is reached.) 
If rstring is specified, the command scans for string from 
the current edit line to the end of the file. If siring is 
found, it is replaced by rstring. If V is specified, 
verification is requested before replacement. If A is 
specified, the command will repeat until the end of the 
file is reached. 

CLEAR EDITOR WORKSPACE 
CLR 

SET TABS 
T[column] [column]. . . 

SET UPPER CASE MODE 
SU 



EDITOR 



SET LOWER/UPPER CASE MODE 
SL 



INSERT LINES 

I 

Lines will be inserted above current edit line. 
Entry of an empty line will end insert. 



ENTER LINE EDITING MODE 
X 

Line editing sub-commands: 



|TAB| — position cursor at next tab stop 



ISPACEI — space forward (destructive) 
Q — space forward (non-destructive 

iBACKSPACll — space backward (destructive) 
g — space backward (non-destructive) 

I INS I — enter or leave character insert mode 



iDELl — delete character 

\J] — go forward in editor workspace 

[J] — go backward in editor workspace 

IRETURNI — leave line editing mode 



ASSEMBLER 

ASSEMBLER OPTIONS 



M — Use macro library 

L — List on CRT 

T — Truncated list 

E — List errors only 

P — List on printer 

B [speed] [delay] — List on serial port 

O — Write relocatable object file 

S — Append symbol table to object file 



DATA DEFINITION PSEUDO-OPS 

EQUATE 
label EQU expression 

DEFINE CONSTANT 
label DC ^expression} [expressionj. . . 

RESERVE STORAGE 
label DS expression 



ASSEMBLER 



ASSEMBLER 



RELOCATION PSEUDO-OPS 

DEFINE ORIGIN 
ORG expression 

BEGIN ABSOLUTE SEGMENT 
ASEG 

BEGIN RELOCATABLE SEGMENT 
RSEG name 

DEFINE GLOBAL SYMBOL 
GLBL I symbol) [symbol]. . . 

MACRO DEFINITION PSEUDO— OPS 

DEFINE MACRO 
macro-name MACRO 

[parameter-name] [.parameter-name] . . . 

END MACRO DEFINITION 
ENOM 

CONDITIONAL ASSEMBLY PSEUDO-OPS 

DEFINE GLOBAL SET SYMBOL . 

I expression | 
'string' 

DEFINE LOCAL SET SYMBOL 

expression ( 
'string' 

BEGIN IF BLOCK 
[if-block-name] IF expression 

BEGIN ALTERNATIVE CONDITION IN IF BLOCK 
ELSEIF expression 

BEGIN LAST ALTERNATIVE CONDITION IN IF BLOCK 
ELSE 

END IF BLOCK 
ENDIF 

EXIT FROM IF BLOCK 
EXITIF [if-block-name] 

BEGIN DO (REPEAT) BLOCK 
[do-block-namej DO expression 

END DO BLOCK 
ENDDO 

EXIT DO BLOCK 
EXITDO [do-block-name] 



set-symbol-name DEFG 



set-symbol-name DEFL 



BEGIN NEXT ITERATION OF DO BLOCK 
NEXTDO [do-block-name] 

END ASSEMBLY 
END [entry-point] 

LIST CONTROL PSEUDO-OPS 
EXPANSION CONTROL 



PRINT 



(OFF j 
) ON \ 

[ ALL ) 



OFF halts listing of assembled lines. 

ON enables listing of lines except for conditional pseudo- 
ops, lines skipped due to conditional pseudo-ops, and 
lines resulting from macro expansions. 

GEN enables listing of lines, including lines resulting from 
macro expansions. Lines which are conditional pseudo- 
ops or lines skipped due to conditional pseudo-ops are 
not listed. 

ALL enables listing of all lines including lines resulting 
from macro expansions, conditional pseudo-ops, and 
lines skipped due to conditional pseudo-ops. 

INSERT SPACE IN LISTING 
SPG 

EJECT TO NEXT PAGE 
EJE 

ESSaa LINKAGE EDITOR 



LINKAGE EDITOR OPTIONS 

L — List on CRT 

p — List on printer 

B [speed] [delay] — List on serial port 

D — Delete unspecified RSEGs 

O — Write absolute object file 

S — Append symbol table to object file 

LINKAGE EDITOR INPUT 

The Linkage Editor will prompt SPECIFY INPUT FILE 
Enter the filenam e. This request will be repeated until yot 
type iRETURNi instead of a filename. Then the Linkage 
Editor will prompt ENTER OUTPUT FILE. Type the 
absolute object filename. The Linkage Editor will ther 
prompt LINKER INPUT. Enter the RSEG s and thei 



ES?^ LINKAGE EDITOR 



locations in memory in the following format: 

»OFIG absolute-address 
{rseg} []rseg]. . . 
ytORG absolute-address 
I rseg } [.rseg] . . . 



iBHM DEBUGGER 
BACKUP DISPLAY 1 LINE 

m 

ADVANCE DISPLAY 1 BYTE 
B 



#END 



DEBUGGER 



DEBUGGER EXPRESSIONS 

Many debugger commands accept an expression 
consisting of the following operands: 

{ digit} [digitj — hexadecimal constant 

'char' — ASCII constant 

t» [tllename:|] [symboQ — symbolic address 

Combined with the following post-unary operators: 
* — treat previous expression as an 

indirect address 
% . — treat previous expression as a 

relative address 
and the following binary operators: 
+ — addition 

— — subtraction 

SWAP CURSOR 

The debugger display is formatted into two logically 
separate halves: the disassembled half and the 
hexadecimal half. Commands operate on each half 
independently. I n orde r to switch which half commands 
affect, hit the ItABI key. 



DISPLAY MEMORY 



^expressions 

If $ is specified, memory around the previously displayed 
address is again displayed. 

ADVANCE DISPLAY 1 LINE 



BACKUP DISPLAY 1 BYTE 

B 

STORE DATA IN MEMORY 
S I constant I [.constant]. . . 

STORE DATA IN REGISTER 

Z |reg = constant | [,reg = constant]. . . 

reg may be any register shown at the top of the display. 

FIND DATA IN MEMORY 
F |constant| [.constant]. . . 

EXECUTE 

E r * 1 

[jBxpresslonJ 

If the parameter is omitted, the cursor address will be used. 
If $ is specified, the address in the PC will be used. 

SINGLE STEP 



STEP 



SET BREAKPOINT 
BS {n} 

Sets breakpoint at cursor address, n may be between Oand 
4. If n = 0 the hardware breakpoint will be used. 

DISPLAY BREAKPOINT 
BD (n) 

RESET BREAKPOINT 
BR 



CLEAR ALL BREAKPOINTS 
BC 



LOAD PROGRAM 

L {filename} [ [offset] [symbol-table-address]] 

filename is the name of the absolute object file. 

offset is an expression specifying how much the program 
is to be offset from its specified load address. No 
relocation is performed. Used in programming PROfds. 

symbol-table-address is an expression which specifies the 
beginning address of where the program's symbol table 
is to be loaded. On completion of the command the 
debugger will display the length of the symbol table. If 
the message PARTLY LOADED is displayed, there was 
not enough memory to load the complete table. 



WRITE PROGRAM 

W {filename} {,start-addr ,end-addr} [,start-addr,end- 
addr]. . . [entry-addr] 

The specified memory locations will be written in 
absolute object format. 

If entry-addr is omitted, the first start-addr will be used as 
the entry point address. 

PROTECT/UNPROTECT MEMORY 
X 

Switches protection for the 1K block in which the cursor 
address is located. 



TRACE EXECUTION 
^ [^expresslonj 

If the parameter is omitted, the cursor address will be used. 
If $ is specified, the address in the PC will be used. 



DISPLAY TRACE DATA 
TR 

MAP USER MEMORY* 
U {addr} [,mask] 

addr is an expression which defines the beginning of a 2K 
region. 



E&iSlii a ANALYZER 



ANALYZER 



SET BREAKPOINT PARAMETERS 



expression )■ 



expression n 
hex4 y 



l(n} [c = {dec}][A = 

={J}] [' = 3 ['^^ = {;}] [°"* = {;}] 

[,E= (blnary4}] 



n — specifies breal<point 0, 
If no parameters are specified 



1, or 2 
the breal<point is reset. 



C — specifies a repetition count 

A — specifies the breal<point address 

D — specifies the data value 

R — specifies a read or write bus cycle 

I — specifies an I/O port or memory access cycle 

Ml — specifies an opcode fetch cycle 

DMA — specifies a DMA cycle 

E — specifies the value of the 4 external lines 

DLY — specifies the number of bus cycles to be delayed 

after the last breakpoint Is reached before data 

collection is terminated 
Omitted parameters are unchanged. 



SET TRACE QUALIFIER PARAMETERS 
r r>\ ^expression) "I r _ (expressionn 



|blnary4j 



If no parameters are specified, all cycles will be recorded. 

A — specifies an address 

D — specifies a data value 

R — specifies a read or write bus cycle 

1 — specifies an I/O port or memory access cycle 

Ml — specifies an opcode fetch cycle 

DMA — specifies a DMA cycle 

E — specifies the value of the 4 external lines 

Omitted parameters are unchanged. 



SET TIMER INCREMENT 
u 

B 

N — specifies 100 nanosecond increments 

U — specifies microsecond increments 

B — specifies bus cycles 



AMDS 
Reference Card 



7^ 



/////_- 



c 





;iP and away in universal development systems. 



PRINTED IN U.S.A 



12-7B 15K 



